CoCo XT & XT-RTC Version 2.5 Release Notes 10-4-90 

>>> READ THIS FIRS 

System Changes 

This disk includes new versions of these programs (compared to 
version 2.4c): 

0S9 Hard disk drivers (BBFHDISK, etc) 
EZGen installation utility 

The other programs on the disk are the same as version 2.4c. If you 

are upgrading from an earlier version of CoCo XT, you can use the 

0S9 IDENT command to determine which modules have changed since your 

old vers i on . 

Version 2.4 also introduced new versions of the CLKGET utility and 
the BASIC driver /format ter programs. The new versions are included 
on the Version 2.5 disk. 

Important Controller Information 

The newer Western Digital controllers sometimes used with CoCo XT 
and CoCo XT-RTC units must be modified if you will be using XT-ROM. 
You must install a 28 pin socket at the location marked U7, and a 
74LS244 IC in the location marked U8. Then install a wire jumper 
across the two points marked R23. DO NOT desolder or clip pins on 
any IC • s on the controller if they are marked WD10C20 or WDIOC22 
this will destroy your controller. 

Easier Installation 



Burke & Burke's EZGen utility is now included with the CoCo XT and 
CoCo XT-RTC. This utility makes it much easier to install a hard 
disk system * 

To add the hard disk software to your existing boot file, you will 
need : 

1) A backup copy of your CoCo XT or CoCo XT-RTC Master Disk, 
with no write protect label (COCO XT DISK) 

2) A freshly formatted floppy disk (NEW DISK) 

3) Your current OS9 System Disk (SYSTEM DISK) 

When you have the above items ready, perform the following steps: 

1) Boot 0S9 from the SYSTEM DISK as you normally would. 

2) Create a copy of your OS9 system on the NEW DISK. For Level 
1, Version l.XX or Level 2 0S9, put the NEW DISK in drive 1 and 
use : 
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OS 9 : load copy renaie 
0S9: cobbler /dl 
OS9: 

If you run Level 1, Version 2. XX 0S9, use the CONFIG program 
instead of COBBLER to create a similar disk. 

DO NOT PUT ANY COMMANDS ON THE NEW DISK AT THIS TIME. Put a 
label on the NEW DISK and leave it in drive 1. 

3) Put the COCO XT DISK in drive 0, and set your execution 
directory as follows: 

OS9: chx /dO/cids 
OS9 : 

4) Use the DDMAKER program to create a hard disk device 
descriptor named "/HD" on the COCO XT DISK. DDMAKER will ask you 
several questions about your drive. Use the tables at the end 
of this section, or in Appendix A of the CoCo XT manual, to 
choose the correct answers. 

OS 9 : ddmaker hd 
OS9 : 



For most applications you should set up the drive for slot 3, 
drive 0, and a step rate of 5. Use 32 for the minimum segment 
size and 22 for the format interleave. 

5) Use EZGen to add the hard disk driver and descriptor to the 
OS9 boot file that you created in step #2. 

NOTE: The name of the device driver must match the name that you 
built into the device descriptor while running DDMAKER. 

Example (Level 2 OS9, /d0 - COCO XT DISK, /dl » NEW DISK): 

OS 9 : ezRen -d /dl/os9boot 

EZGen Version 1.06 

Copyright 1988 by Burke & Burke 

All Rights Reserved 



Special processing for 0S9Boot enabled. 
Creating work file • /d 1 /ezgen . 3 • . . • 
EZGen> link rbf 
EZGen) next 



EZGen> insert /d0/cmds /hd . dd 

EZGen) insert /dO/modu les /bbf hdi sk . dr 

EZGen) quit 

Creating contiguous ' /d 1 /os9boot f from ' /d 1 /ezgen . 3 ' 

Creating empty file • • • 

Looking for xxx contiguous clusters • • . 

Copying data to file • • • 

Allocating clusters ... 
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Updating file descriptor sector Sxxxx • . • 
Recording new location of standard boot * • 
Exiting . . . 

OS9: 

Please refer to the EZGen manual in the HELP directory of the 
CoCo XT Master disk for further information about EZGen 
commands • 

6) Level 2 users must prepare the new disk for booting by 
placing the SYSTEM DISK in drive and entering: 

OS 9 : chx /dO/cmds 

OS 9 i makdir /dl/emds 

0S9: copy /dO/cmds/shell /d 1 /cmds / shel 1 »20k 

OS 9 : copy /dO/cmds /gr f drv /d 1 /cmds /gr f dr v it 20V. 

OS9: 

7) Remove the SYSTEM DISK from drive 0, and put the NEW DISK in 
drive 0. Then press RESET to reboot the system. 

NOTE: If you get a "BOOT FAILED" message at this point* please 
refer to the "Boot Failures" section of these notes. 

8) To format the drive, put the SYSTEM DISK back in drive and 
enter the following commands: 

OS9: chd /dO 

OS 9 : chx /dO/cmds 

OS9 : format /hd 



OS9 : 

The formatter will ask you several questions. Respond to all 

questions with "Y". Physical formatting takes about 6 minutes, 

and logical verification takes about 45 minutes, for a 20 Meg 
drive • 

9) When formatting is complete, copy all of the files on your 
SYSTEM DISK to the hard disk: 

0S9 : load copy 

0S9 : dsave -s20 /dO /hd I shell 



0S9: 

10) Place the NEW DISK in drive 1, and the CoCo XT DISK in drive 
0. Then use EZGen to change the name of your hard disk from 
"/hd" to "/h0", and also to install a default descriptor that 
refers to the hard disk: 
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OS9 : chx /dO/cmds 

OS 9 : ezgen -d /dl/os9boot 



EZGen) -1 hd 



EZGen> -r hO 



E2Gen> -1 dd 



EZGen) -u /dO/cmds / hd . dd 

EZGen> -r dd 

EZGen) <l 

• 

OS9: 

You may get a "248 error* 9 . This means that there is not enough 
contiguous space on the NEW DISK for EZGen to create a new 
OS9Boot file* You can solve this by copying the OS9Boot file to 
another disk, deleting it from the NEW DISK, and then copying it 
back. When this has been done, repeat the EZGen step above. 

11) Your hard disk system is now installed and ready for 

operation. The NEW DISK is your new OS9 System Disk. Place the 

NEW DISK in drive 0, and reboot by pressing RESET, to bring up 
the new system. 

Single Drive Installation 

Use EzGen to install the hard disk modules even if you have only a 
single floppy disk. Single-drive installation requires the same 
items as the two-drive procedure above. 

1) Boot OS9 from the SYSTEM DISK as you normally would. 

2) Create a copy of your 0S9 system on the NEW DISK. To do 
this, follow the example below: 

(SYSTEM DISK in drive 0) 

OS 9 : load copy rename load unlink makdir cobbler 

(NEW DISK in drive 0) 

OS 9 : cobbler /dO 

OS 9 : unlink cobbler 

OS 9: makdir /dO/cmds 

OS9 : unlink makdir 

0S9: 

If you run Level 1, Version 2 . XX 0S9, you can use the CONFIG 
program instead of COBBLER to create a similar disk. 

DO NOT PUT ANY COMMANDS ON THE NEW DISK AT THIS TIME. Put a 
label on the NEW DISK and remove it from drive 0. 

3) Use the DDMAKER program to create a hard disk device 
descriptor named "/HD" on the NEW DISK. DDMAKER will ask you 
several questions about your drive. Use the tables at the end 
of this section, or in Appendix A of the CoCo XT manual, to 
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Recording new location of standard boot . • • 
Exiting • . . 

OS 9 : unlink ezften 
0S9: 

Please refer to the EZGen manual in the HELP directory of the 
CoCo XT Master disk for further information about EZGen 
commands . 

6) Level 2 users must prepare the new disk for booting by 
copying two files: 

(SYSTEM DISK in drive 0, NEW DISK ready) 
0S9: chx /dO/cmds 

0S9; copy -s /dO/cmds/shell /dO/crads /shel 1 //2 0k 
OS 9 : copy -s /dO/cmds /gr f dr v /dO/cmds /gr f dr v 020k 
OS9 : 

7) Continue with steps 7-11 of the two-drive procedure. Before 
step 10, you will need to load EZGen into memory from the COCO 
XT DISK. 



DDMAKER Cheat Sheet 



WD1002-WX1/ WD1002-27X/ Adaptec 2072/ 
WDXT-GEN(2); WD1004-27X; Seagate ST-11R; 
Question ST-225 20 Meg ST-238 30 Meg ST-238 30 Meg 



Driver name Use BBFHDISK for level 2, BBlFHDISK for LI, V2, 

and BBXFHDISK for LI, Vl. 

Slot # Use the apropriate slot number (normally 3) 

Step Rate 5 5 5 

Tracks / surface 612 940 612 

Precompensat ion 300 450 300 

Number of surfaces 4 4 4 

Sectors / track 32 32 48 

Park track 670 1022 670 

Verify writes Enable or disable this feature as you like. 
Segment size Use 32 here for all drives & all 0S9 versions 

Interleave 22 22 33 



NOTE: If your equipment is not listed here, check Appendix A of the 
CoCo XT manual or call the hard drive manufacturer. 



Boot Failures 

Here are the most common causes for Level 2 BOOT FAILED messages. 
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choose the correct answers. 

(COCO XT DISK in drive 0) 
OS 9 : load /dO / cmd s / ddroaker 
(NEW DISK in drive 0) 
0S9: chd /dO;chx /dO/cwds 
OS 9 : ddroaker hd 
OS9 : 

For »ost applications you should set up the drive for slot 3, 
drive 0, and a step rate of 5. Use 32 for the minimum segment 
size and 22 for the format interleave. 

4) Load the EZGen command and copy the desired device driver 
from the COCO XT DISK to the NEW DISK. 

NOTE: The name of the device driver must match the name that you 
built into the device descriptor while running DDMAKER . 

Example using Level 2 "bbf hd isk . dr " driver: 

(COCO XT DISK in drive 0, NEW DISK ready) 

OS 9 : load /dO/crnds/ezgen 

OS 9 : copy -s /dO /modul es /bbf hdi sk . dr 

/dO/bbf hdisk.dr 
0S9 : 

5) Use EZGen to add the hard disk driver and descriptor to the 
0S9 boot file that you created in step 02. 

NOTE: The name of the device driver must match the name that you 
built into the device descriptor while running DDMAKER. 

Example (Level 2 0S9): 

(NEW DISK in drive 0) 

OS 9 : ezgen -d /d0/os9boot 

EZGen Version 1 .06 

Copyright 1988 by Burke & Burke 

All Rights Reserved 



Special processing for 0S9Boot enabled. 
Creating work file • /d 1 /ezgen . 3 ■ . . . 
EZGen> link rbf 
EZGen) next 



EZGen) insert /dO/cmds /hd . dd 

EZGen) insert /dO/ bbf hdisk.dr 

EZGen) quit 

Creating contiguous • /d0/os9boot ' from • /d0/ezgen . 3 • . . . 

Creating empty file • . • 

Looking for xxx contiguous clusters ... 

Copying data to file • 

Allocating clusters . . . 

Updating file descriptor sector $xxxx . • • 
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1) No CMOS directory on the boot disk 

2) SHELL and GRFDRV not present in ends directory on 
boot disk 

3) Incorrect file attributes -- the 'e* attribute MUST 
be set on both SHELL and GRFDRV 

4) Hard drive device descriptor is "/hd" or H /d0", but 
hard drive has not yet been formatted 

5) Level 2 0S9 "boot order" bug. 

Many Level 2 0S9 users have had problems when installing new device 
drivers. The problems are often solved by changing the order of the 
modules in OS9Boot. Some users call this the "boot order" bug. 

Many Color Computer experts believe that the "boot order" bug is 
actually caused by slight timing variations in the CoCo 3 t 
Multi-PAK, and external devices. The CoCo XT and CoCo XT-RTC 
circuit boards include circuitry to protect against these timing 
problems, but many older floppy controllers do not. 

You can use EZGen to rearrange your boot file if you suspect boot 
order problems. A sequence that works for many users is: 

1) Put the CoCo XT disk in drive t and the BOOT FAILED disk in 
drive 1 

2) Enter the commands: 

OS 9 : chx /dO/cmds 

OS 9 : ezgen -kd /dl/os9boot 

3) When you see the EZGen> prompt, enter the commands: 

EZGen> link cc3io 



EZGen) 


save /dl/x 


EZGen) 
EZGen) 
EZGen) 


delete 
link rbf 
insert /dl/x 


EZGen) 


$del /dl/x 


EZGen) 


quit 



Try booting the disk again. If you still get BOOT FAILED, check 
your work. If you are still stuck, call Burke & Burke for technical 
assistance . 



New Device Drivers 



The OS9 hard disk formatting routine has been modified to skip over 
defective tracks on the hard disk. 0S9's FORMAT command will mark 
off the bad tracks when you perform a PHYSICAL VERIFY. 

You do not need to reformat your hard drive in order to use the new 
drivers. Just use 0S9GEN or CONFIG to create a new boot disk that 
includes new device descriptors and the new driver of your choice. 
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Use only a current version of DDMAKER to create device descriptors 
for use with the new device drivers. Releases of CoCo XT software 
previous to version 2.0 used a different device descriptor format 
that is incompatible with Version 2.3 

Page 3-6 of the manual should indicate that the slot number is 
stored at device descriptor offset $16 (IT. DNS), not offset $15. 

Beginning with Version 2.0, the hard disk interface may be installed 
in any slot. Versions of the CLKSET, CLKGET and RTC utilities are 
provided for use with each slot. 



Improved Clock Support 

The CLKGET utility has a new command line option. If you use the 
command 1 ine : 

clkget -d & 

in your startup file, CLKGET will set your system clock as usual; it 

will also automatically correct your system clock once every 8 

minutes. A new version of CLKGET has been provided on the Version 
2.4 release disk. 

Burke & Burke has included a listing of a short machine language 
program that reads and sets the time under BASIC. The program is in 
the file "CLKIO . SRC" on the BASIC portion of the CoCo XT-RTC disk. 
WARNING -- THIS PROGRAM IS NOT SUITABLE FOR USE WITH 0S9. 

If your controller is installed in Multi-PAK slot #3» you should use 

the utilities named CLKSET3, CLKGET3, and RTC3 . You can rename 

these utilities to CLKSET, CLKGET, and RTC in your commands 
directory . 

Similarly, four real-time clock libraries are provided under RS-DOS 
-- one for each slot. These libraries are called RTCLIB1 .BIN, 
RTCLIB2.BIN, RTCLIB3.BIN, and RTCLIB4.BIN. 

The RS-DOS RTCLIB routine has been modified to correctly check the 
number of days per month when setting the date from a BASIC string 
var iable • 



New Version of XTFMT 

Versions of XTFMT previous to Version 2.2 did not initialize the 
hard disk controller prior to formatting the drive. The default 10 
Meg parameters were used instead. This only causes problems on 
drives that have not been pre- format ted . 

The Version 2.5 XTFMT.BIN program initializes the controller and 
skips over defective hard disk tracks, formatting the drive as 
specified in the device descriptor. 
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New Version of XT. PR & XTDSKINI.DR 

Version 2.4 of HYPER-I/0 device drivers XT.DR and XTDSKINI.DR would 

not correctly initialize newer hard disk controllers like the 

WDXT-GEN2. This caused the controller to use the default 10 Meg 
parameters . 

The Version 2.5 drivers correctly initialize both old and new 
control lers • 



Hard Disk Controller Information 



The model numbers of hard disk controllers supported by Version 2.5 
are : 



Western Digital WD1002-WX1 (MFM) 

Western Digital WD1002A-WX1 (MFM) 

Western Digital WDXT-GEN (MFM) 

Western Digital WDXT-GEN2 (MFM) 

Western Digital WD1002-27X (RLL) 

Western Digital WD1002A-27X (RLL) 

Western Digital WD1004-27X (RLL) 

Seagate Technology ST-11R (RLL) 

Adaptec 2072 (RLL) 



Controllers made by Everex, OMTI, and several other vendors have 
also been used successfully with the CoCo XT. 

The Western digital controllers use 32 or 48 sectors per track. 

The Adaptec and Seagate RLL controllers use 48 sectors per track, 
and do not have a W9 jumper. Newer Western Digital RLL controllers 
provide jumpers Wl and W2 (both in for 32 SPT) in place of W9 . 

If you are using the Western Digital WDL002-27X hard disk 
controller, you can emulate 32 sectors per track by installing 
jumper W9 and using 1.53 times the normal number of tracks in your 
device desriptor. Use 940 tracks for the ST-238R hard drive. The 
park track should also be increased by a factor of about 1.53, but 
must not exceed 1023. 

If you are using the Western Digital WD1002A-27X hard disk 
controller, you can emulate 32 sectors per track by installing 
jumpers Wl and W2 . The 1.53 track scaling factor still applies. 
Remove both jumper Wl and jumper W2 to operate at 48 sectors per 
track, with the normal number of tracks. 



Backing Up your Hard Disk 

The HDB and HDR utilities on the CoCo XT disk can be used to back-up 
and restore your hard disk to multiple floppy disks. These 
utilities make an EXACT copy of your hard disk, so all boot files, 
HYPER-I/0 MSA's, and other special files are preserved intact. 
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These utilities have been Modified to recover fron read or write 
errors encountered during execution. Burke & Burke has also added a 
new data compression option, selected by specifying "-c" on the 
cossand line. Data compression reduces the number of disks required 
by 20-30Z, but roughly doubles the time required for the backup* 

Other backup utilities are faster or easier to use than HDB, but may 
"lose" the 0S9 Boot file or other special files. If you use Burke & 
Burke's XT-ROM boot ROM, be sure to use BootPort to save the hard 
disk boot to a floppy disk before using any non-HDB backup utility. 
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